Quyết Toán Tài Khoản
Đường dẫn
- URL:
/cb-core/api/v1/settlement/create-transaction - Method:
POST - Mô tả: API được dùng để tạo yêu cầu quyết toán cho tài khoản merchant trong Baokim.
Request
Bảng Request
| Tham số | Kiểu dữ liệu | Bắt buộc | Mô tả |
|---|---|---|---|
| request_id | string(50) | Có | Mã duy nhất tương ứng với yêu cầu. Định dạng đề xuất: MerchantCode + BK + YYYYMMDD + UniqueId |
| request_time | string(19) | Có | Thời gian gửi yêu cầu từ merchant. Định dạng: YYYY-MM-DD HH:MM:SS |
| merchant_code | string(20) | Có | Merchant code được cung cấp bởi Baokim trước khi tích hợp |
| sub_merchant_code | string(50) | Có | Mã cho sub-merchant, hoặc merchant code của bạn nếu seller là direct |
| reference_id | string(50) | Có | Mã giao dịch được gửi bởi merchant |
| bene_bank_no | string(6) | Có | Đây là ngân hàng của người thụ hưởng. Điền bank_no trong phản hồi của API Lấy danh sách ngân hàng |
| bene_acc_no | string(22) | Có | Số tài khoản của người thụ hưởng |
| bene_amount | int(9) | Có | Số tiền mà người thụ hưởng sẽ nhận được sau khi hoàn thành giao dịch chi hộ |
| memo | string(100) | Không | Nội dung chuyển tiền |
| currency_code | string(10) | Có | Mã tiền tệ của giao dịch chi hộ. Điền VND cho giao dịch VND |
Ví dụ Request
{
"request_id": "MERCHANT12345678901234510281",
"request_time": "2024-11-15 14:36:00",
"merchant_code": "PHUONGTT",
"sub_merchant_code": "SUBPHUONGTT",
"reference_id": "1234567890",
"bene_bank_no": "123456",
"bene_acc_no": "1234567890123456789012",
"bene_amount": 300000,
"memo": "Payment for services",
"currency_code": "VND"
}
Response
Bảng Response
| Tham số | Kiểu dữ liệu | Mô tả |
|---|---|---|
| response_code | int(4) | Mã lỗi từ Baokim theo Bảng Mã Lỗi |
| response_message | string(200) | Mô tả mã lỗi từ Baokim theo Bảng Mã Lỗi |
| reference_id | string(50) | Thông tin merchant được gửi |
| transaction_id | string(50) | Mã giao dịch được ghi lại phía Baokim |
| transaction_time | string(50) | Thời gian hoàn thành phía Baokim. Định dạng: YYYY-MM-DD HH:MM:SS |
| bene_bank_no | string(6) | Đây là ngân hàng của người thụ hưởng. Điền bank_no trong phản hồi của API Lấy danh sách ngân hàng |
| bene_acc_no | string(22) | Số tài khoản của người thụ hưởng. |
| bene_acc_name | string(50) | Tên đầy đủ tài khoản ngân hàng của người thụ hưởng |
| bene_acc_type | int(1) | Loại tài khoản của người thụ hưởng. Điền 0 cho số tài khoản ngân hàng, 1 cho số thẻ ngân hàng |
| bene_amount | decimal(18,2) | Số tiền mà người thụ hưởng sẽ nhận được sau khi hoàn thành giao dịch chi hộ |
| actual_bene_amount | decimal(18,2) | Số tiền thực tế chuyển cho người thụ hưởng. Sẽ ít hơn bene_amount trong request nếu có phí chi hộ cho người thụ hưởng |
| detail_status | string(200) | Mô tả chi tiết mã lỗi từ Baokim |
Ví dụ Response
{
"response_code": 200,
"response_message": "Success",
"reference_id": "MerchantRef12345",
"transaction_id": "BKTrans987654321",
"transaction_time": "2024-11-06 10:15:30",
"bene_bank_no": "001122",
"bene_acc_no": "1234567890123456789012",
"bene_acc_name": "John Doe",
"bene_acc_type": 0,